home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1998 August: Tool Chest / Dev.CD Aug 98 TC.toast / Tool Chest / Testing & Debugging / Virtual User / Virtual User Current Release / Examples / Example External Tools / ProcessTool / VUAE.h < prev    next >
Encoding:
C/C++ Source or Header  |  1998-06-04  |  2.8 KB  |  80 lines  |  [TEXT/MPS ]
  1. /*
  2.  *    File:        VUAE.h
  3.  *
  4.  *    Contains:    This file is part of the Virtual User 2.0 external tool interface.
  5.  *
  6.  *    Written by:    Automation Systems, Apple Computer, Inc.
  7.  *
  8.  *    Copyright:    © 1992-1994 by Apple Computer, Inc., all rights reserved.
  9.  *
  10.  *    Change History (most recent first):
  11.  *
  12.  *         <2>     1/13/94    CMW        Changed for Virtual User 2.1: kVUAESrvcResults = keyDirectObject
  13.  *         <9>    11/18/92    CMW        Add event id and wait amount parameter for dealing with
  14.  *                                    timeouts. Removed unused parameter consts for GetToolVers.
  15.  *         <7>    11/13/92    RV        
  16.  *        <6+>    11/13/92    RV        
  17.  *         <6>    11/12/92    CMW        Change occurances of "GetToolVers" to "GetToolVersion". Rename
  18.  *                                    all constants starting with kAEVU to start with kVUAE.
  19.  *         <5>     11/2/92    RV        Added Initialize string constant
  20.  *        <4+>     11/2/92    RV        Add "Initialize" string constant
  21.  *        <2+>     5/29/92    CMW        Change all occurances of "Command" to "Service" in the names of
  22.  *                                    all the constants and events.
  23.  *        <1+>     3/11/92    CMW        Update to reflect the changes to the External Tool calls for
  24.  *                                    2.0d3
  25.  *         <1>     2/20/92    JCC        
  26.  *         <4>     2/19/92    JCC        Finishing touches
  27.  *        <3+>     2/19/92    JCC        
  28.  *         <3>     2/13/92    JCC        Rewriting the pascal commands in C
  29.  *        <2+>     2/13/92    JCC        Rewriting the pascal commands in C
  30.  *         <2>     2/13/92    CMW        Add 'errAENoErr' to errors enumeration, convert #define'd
  31.  *                                    constants to 'const's, and fix the font.
  32.  *
  33.  *    To Do:
  34. */
  35.  
  36.  
  37. #ifndef __VUAE__
  38. #define __VUAE__
  39.  
  40. #ifndef __TYPES__
  41. #include <Types.h>
  42. #endif
  43.  
  44. #ifndef __APPLEEVENTS__
  45. #include <AppleEvents.h>
  46. #endif
  47.  
  48. /* Standard constants used for communicating with VU External Tools */
  49. const long kVUAETool            = 'v.u.';    /* event class for V.U. 2.0 external tool interface */
  50. const long kVUAESendService        = 'extc';    /* event id for SendToolService */
  51. const long kVUAEWaitLonger        = 'extw';    /* event id for WaitLongerForService */
  52.  
  53. const long kVUAESrvcName        = keyDirectObject;    /* Service name for external tool Service */
  54. const long kVUAESrvcParameters    = 'extp';
  55. const long kVUAESrvcResults        = keyDirectObject;
  56. const long kVUAESrvcTarget        = 'targ';
  57. const long kVUAEWaitAmount        = 'xtwa';
  58.  
  59. const long kVUAEOldSrvcResults    = 'extr';    /* Do not use for future development: */
  60.                                             /* (this is not AppleScript friendly) */
  61.  
  62. /* Errors specific to the VU External Tool Interface*/
  63. enum VUAEErrors
  64. {
  65.     errAENoErr = 0,
  66.     errAENeverReturnThisErrorCode = 1,    /* Never EVER return this number as an error code!!! */
  67.     errAEValueTooSmall = 2,
  68.     errAEWrongParameters = 3,            /* incorrect parameters passed to external tool */
  69.     errAEUnknownService = 4
  70. };
  71.  
  72. const char* kVUAEInitialize        = "Initialize";
  73. const char* kVUAECancelService    = "Cancel";
  74. const char* kVUAEGetToolVersion    = "GetToolVersion";
  75. const char* kVUAEGetServiceList    = "GetToolServices";
  76. const char* kVUAEHasService        = "ServiceSupported";
  77. const char* kVUAEQuitService    = "Quit";
  78.  
  79. #endif
  80.